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MKTF nn ffnH PATA ^CESS COTO GENERATION 

FIELD f)f THE INVENTION 

This invention relates in general to the field of computer software and more particularly to 
data access code generation utilizing templates. 

5 BACKGROUND OF THft IN VENTION 

The introduction of Java, an object-oriented, multi-threaded, portable, platform-independent, 
secure-programming environment, and its wide acceptance on the World Wide Web, requires 
programmers to migrate existing code and develop now code in Java. 

10 In object-oriented programming such u Java, a class is a template definition of the methods 

and variables in a particular kind of object. For example, classes may be created for graphical user 
interface elements such as windows and tool bars and also for database interfaces. Li general, classes 
provide an overall framework for developing an application program. 

15 To address the requiromentB of commercial World Wide Web publishing and enable the 

expansion of World Wide Web technology, the World wide Web Consortium has developed an 
Extensible Markup Language (XML). XML allow9 the creation of Java-based World Wide Web 
applications that were not previously possible. 

ao Traditionally, Java classes have been manually created requiring the user to have knowledge 

of proprietary backend data access Application Program interfoces (APIs). The manual generation 
of Java classes can often be complex and very time-consuming resulting in inconsistent code 
generation. Furthermore, for different APIs, specifio Java classos must be generated to provide 
access to the backend data. 

25 

As a result of these difficulties, there is a need for an adaptive, modifiable, extensible and 
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reusable sujuuun iu gcmRUug javo twaaca, 

It is, therefore, an object of this invention to provide a method and apparatus for generating 
data access Java glasses. 

It is a further object of this invention to provide a method and apparatus far generating data 
access Java classes utilizing templates. 

SUMMARY OF Tfitt ITNfVENTTQN 
io According to the invention there is provided a method and apparatus for data access code 

generation. A data access code generator routine applies code generation templates to an Extensible 
Markup Language (XML) document to generate the necessary dam access Java classes. 

The XML document describes a data object and the mapping of the data object to Java 
15 objects. The XML file must be created pursuant to the data model that exists in the backend 
Application Program Interface (API) as each backend API generally requires specific elements, 
attributes and mappings to facilitate backend data access. The details of each data model are defined 
in a data object Data Type Definition (DTD) document, 

20 The code generation templates contain the support for the backend API data access calls that 

arc required to create the necessary Java classes from the XML file. The code generation template 
is implemented in any transformation language that can convert XML into Java code. 

In operation, the data access code generator routine applies code generation templates to an 
23 XML document containing a data object description* which creates the resulting Java classes. 

Other objects and advantages of the invention will become clear from the following detailed 
description of the preferred embodiment, which is presented by way of illustration only and without 
limiting die scope of the invention to the details thereof. 
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reusable solution to generating Java classes. 

It is, therefore, an object of this Invention to provide a method and apparatus for generating 
data access Java classes. 

5 

It is a further object of this invention to provide a method and apparatus fiat generating data 
access Java classes utilizing templates. 

SUMMARY OF THE INVENTION 

10 According to the invention there is provided a method and apparatus for data access code 

generation. A data access code generator routine applies code generation templates to an Extensible 
Markup Language (XML) document to generate the necessary data access Java classes. 

The XML document describes a data object and die mapping of the data object to Java 
is objects. The XML file must be created pursuant to the data model that exists in the backend 
Application Program Interface (API) as each backend API generally requires specific elements, 
attributes and mappings to facilitate backend data access. The details of each data model are defined 
in a data object Data Type Definition (DTD) document* 

20 The code generation templates contain the support for the backend API data access calls that 

are required to create the necessary Java classes from the XML file. The code generation template 
is implemented In any transformation language that can convert XML into Java code. 

In operation, the data access code generator routine applies code generation templates to an 
25 XML document containing a data object description, which creates the resulting J ava c] asses, 

Other objects and advantages of the invention will become clear from the following detailed 
description of the preferred embodiment, which is presented by way of illustration only and without 

limiting the scope of the invention to the details thereof. 
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H»TCT ngSCftTPTION OF THE DRAWINGS 

Further features and advantages will be apparent from the following detailed description, 
given by way of example, of q preferred embodiment taken in conjunction with the accompanying 
drawings, wherein: 

5 Fig. 1 is a schematic block diagram of a data access code generator system. 

PETATLED DESCRIPTION OF Tffft riWENTTON 

Throughout the figures, like elements arc indicated by like reference number?. 

10 Referring to Fig. 1, a data access code generator 10 is depicted having a data access code 

generator routine 18 and code generation templates 16. 

The data accesa code generator routine 18 takes the code generation templates 16 and the 
XML data object description 14 as inputs and produces the necessary data access Java classes 20. 

is 

The XML data object description 14 is a document created pursuant to the data model that 
exists in the backend. The data model U defined in a data object Document Type Definition (DTD) 
document 12. The data object DTD 12 contains all of the backend APIs definitions for the elements, 
attributes and mappings that are required to provide access to the backend data at run-time. For 
20 example, a system that accesses a relational database backend will contain attributes and elements 
for column names and the mapping of the columns to Java attributes, 

Every object description contained within the XML data object description 14 must conform 
to the elements, attributes and mappings defined in the data object DTD 12. Further, the XML data 
25 object description 14 must be supported by the data access code generator routine 18. 

The code generation templates 16 describe the code that is generated when the data access 
code generation routine 18 is invoked. The code generator templates 16 contain the following 
elements; 
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data access API calls for tho bacterids that are supported in the data object DTD; 
the implementation of system-wide policies such as caching, lazy initialization, logging and 
the use of system infrastructure; and 
rules for code generation. 

s In particular, the incorporation of rules for code generation allows for tho simple, straightforward 
and consistent generation of Java classes. 

The code generation templates 16 are implemented in any transformation language that can 
convert XML into Java code. For example, the code generation templates 16 can be implemented 
LO in a transform mechanism such as Extensible Stylesheet Language (X9L) in which case the code 
generation templates 16 are actually XML files. 

in operation, the method and apparatus for data access code generation commences with an 
author creating an XML data object description 14 describing a data object. The description of the 
13 data object must conform to the elements, attributes and mappings defined in the data object DTD 
12. The data access code generator routine 18 then takes the code generation templates 16 and the 
XML data object description 14 as Inputs and produces the necessary data access Java classes 20 to 
provide access to the backend data at run-time. 

20 One of the advantages of using a data access code generator routine 18 in conjunction with 

the code generation templates 16 is that programmers need not learn the proprietary backend APIs. 
The specific calls for each proprietary backend API are contained only in the code generation 
templates 16, where they are applied to the XML data object description 14 to create the necessary 
data access Java classes 20. This provides the further advantage of allowing the protection of 

25 proprietary information as programmers may be provided with the code generation templates 16 
instead of the details of each proprietary backend API. 

This method and apparatus also provide tho advantage of allowing system-wide changes and 
enhancements to be made by simply regenerating the data access Java classes using modified code 
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generation templates 16 or by simply modifying the dote object description in the XML document 
14. 

Furthermore, through simply modifying the code generation templates 16, different policies 
5 can be applied without the need to edit each of tho resulting data access Java classes 20. 

Therefore, this method and apparatus for data access code generation provides the advantages 
of modifiability, extensibility, adaptation and reusability. The modifiability of the data object 
description in the XML document and the code generator templates provides clear advantages over 
10 the manual creation and modification of Java classes. Consequently, a single XML data object 
description may be used in conjunction with several different code generation templates to create 
data access java classes for different backend APIs. Furthermore, the code generation templates can 
be modified to include system modifications and the datn access Java classes regenerated without 
the need to edit each resulting data access Java class. 

15 

Accordingly, while this invention has been described with reference to Illustrative 
embodiments, this description is not to be construed in a limiting sense. Various modifications of 
the illustrative embodiments, as well as other embodiments of the Invention, will be apparent to 
persons skilled in the art upon reference to this description. 

20 

For example, any object-oriented programming environment, such as C++, may be 
substituted for Java. Furthermore, a single code generation template may be used, or a plurality of 
code generation tcmplatesmay be used. Similarly, the data access code generatorroutine may create 
a single data access Java class or it may create a plurality of data access Java classes. 

25 

It is therefore contemplated that the appended claims will cover any such modifications or 
embodiments as fall within the true scope of the invention. 
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The embodiments of the invention in which an exclusive property or privilege is claimed are defined 



1 . A method of data access code generation, comprising; 

a) describing o data object in a data object description document; 

b) applying at least one code generation template to said data object description 
document; 

c) generating at least one data access class . 

2. The method according to claim 1 , wherein said data object description document conforms 
to a data object document type definition. 

3. The method according to claim I .wherein step b) and c) are performed by a data access code 
generator routine. 

4. The method according to claim 1 , wherein said at least one data access class is a data access 
Java class, 

5. The method according to claim 1 . wherein said data object description document is created 
in Extensible Markup Language (XML). 

6. The method according to claim l t wherein said at least one code generation template is 
implemented in a transformation language. 

7. The method according to claim 6. wherein said transformation language is Extensible 
Stylesheet Language (XSL). 

8. The method according to claim 3 k wherein said data access code generator takes said data 
object description document and said at least one code generation template as inputs and 
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outputs said at least one data access class, 

9. A method of generating data access Java classes, comprising: 

a) creating a XML data object description; 

b) applying a plurality of code generation templates to said XML data objoct 
description; 

c) generating at least one data access Java class, 

10. The method according to claim 9, wherein said XML data object description is created 
pursuant to a data object document type definition. 

11. The method according to claim 9, wherein steps b) and c) are performed by a data occes9 
code generator routine. 

1 2 . The method according to cl aim i 1 , wherein said data access code generator takes said XML 
data object description and said at least one code generation template as inputs and outputs said at 
least one data access Java class. 

13. A method of data access code generation in an object-oriented programming environment, 
comprising: 

a) describing a data object in a data object description document; 

b) applying at least one code generation template to said data object description 
document; 

e) generating at least one data access class. 

14. The method according to claim 13, wherein said object-oriented programming environment 
is Java. 

CA9-2000-0004 7 



CA 02306933 2000-04-28 



1 5. The method according to claim 13, wherein said data object description document conforms 
to a data object document typo description. 

16. The method according to claim 13, wherein said code generation template is an Extensible 
5 Stylesheet Language (XSU document 

17. An apparatus for generating data access code comprising: 

a) a data object descriptor, 

b) a least one code generation template; and 

xq o) a code generator operative to generate at least one data access class. 

18. The apparatus according to claim 17, wherein said data object descriptor is operative to 
describe a data object that confotmfi to a data object document type definition. 

15 1 9. The apparatus according to claim 1 7, wherein said at least one code generation template is 
operative to define the transformation of said data object description to said at least one data access 
class. 

20. The apparatus according to claim 17, wherein said at least one data access class is a data 
20 access Java class, 

21. The apparatus according to claim 17, wherein aaid data object descriptor is created in 
Extensible Markup Language (XML). 
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